package org.dromara.system.mapper;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.toolkit.Constants;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.apache.ibatis.annotations.Param;
import org.dromara.common.mybatis.annotation.DataColumn;
import org.dromara.common.mybatis.annotation.DataPermission;
import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
import org.dromara.system.domain.SysPost;
import org.dromara.system.domain.vo.SysPostVo;

import java.util.List;


/**
 * @Author 刘武贵
 * @Date 2024/8/15 22:00
 * @Description 功能描述：岗位信息 数据层
 */
public interface SysPostMapper extends BaseMapperPlus<SysPost, SysPostVo> {

    /**
     * 查询岗位列表（分页）
     * 该方法使用了数据权限注解(@DataPermission)，指定了数据列的权限控制规则
     * 具体规则包括：
     * 1. 针对"deptName"列，权限控制基于"dept_id"字段
     * 2. 针对"userName"列，权限控制基于"create_by"字段
     * 这意味着，只有当用户具有访问特定部门或特定创建者数据的权限时，才能查看相应的岗位信息
     *
     * @param page 分页对象，用于分页查询
     * @param queryWrapper 查询条件封装对象，用于动态查询
     * @return 返回分页查询结果，包含查询到的岗位信息列表
     */
    @DataPermission({
        @DataColumn(key = "deptName", value = "dept_id"),
        @DataColumn(key = "userName", value = "create_by")
    })
    Page<SysPostVo> selectPagePostList(@Param("page") Page<SysPostVo> page, @Param(Constants.WRAPPER) Wrapper<SysPost> queryWrapper);

    /**
     * 查询用户所属岗位组
     *
     * @param userId 用户ID
     * @return 结果
     */
    List<SysPostVo> selectPostsByUserId(Long userId);

}
